ACCEL3 COMPILER FOR TR5-80 BASIC 



(C) COPYRIGHT SOUTHERN SOFTWARE 1982 



ACCEL3, including all programs and files provided, and all documentation, including this 
manual, is copyrighted by the author and all rights are reserved. Copying of 
machine-readable material is permitted for backup purposes by the original purchaser only. 
Copying of programs for other users is an infringement of the copyright, and is illegal, 



ACCEL3 is Southern Software's latest compiler for TRS-80 BASIC. ACCEL3 produces more 
compact code than ACCEL and ACCEL2, it compiles faster, its treatment of FOR-NEXT 
^°7^ S T f ^ r 5f dl >'- strijctured l0 °PSt it optimises more language constructs, and it supports 
oWr 7 RUN> CSAVE and c LOAD of compiled programs, It will compile the full DISK 

BASIC language, and will tolerate many non-Tandy language extensions (though not all). 

ACCEL3 occupies less than 5632 bytes. This relatively low size is achieved by a technique 
of selective compilation. For instance I/O statements such as LFRINT or INPUT are not 
translated at all but remain in the compiled program in their source form, and are executed 
by the resident BASIC interpreter, Statements involving INTEGERS and flow-of-control 
statements (GOTO, GOSUB, RETURN) are, by contrast, translated to directly-executed Z30 
machine-instructions. Other, more complex statements are translated into calls to ROM 
routines. ACCEL3 selects more statements for translation than ACCEL, notably those 
involving STRINGS and SINGLE and DOUBLE data-types. ACCEL3 also translates 
references to array elements (even when the array has dynamic bounds), and it translates 
more functions than ACCEL and ACCEL2. 



i 







ACCEL3 SUPPLIED ON T APT? 

If you have purchased ACCEL3 on diskette, skip the next four sections* 

The tape supplied is self-relocating. This gives you the freedom to load the compiler 
anywhere in memory you please. It also provides the freedom to make mistakes, so please 
check all address arithmetic carefully. Tou need only perform the installation operation 
once, and then you can take your own back-up copies on tape or disk, for subsequent direct 
loading. 

For both Model I and Model III you must load the tape supplied under Level2 (not DISK 
BASIC) using the SYSTEM command, and at the low cassette data rate. (On Model III specify 
L at bring-up). It will load itself at locations 13944 and up, and then, under your control, 
will relocate itself to any chosen location above this. The compiler will not run correctly 
unless it is loaded in PROTECTED memory. Depending on how much RAM you have, and Dn 
what other machine-language programs you want resident, decide where you want to locate 
it. The table overleaf gives addresses that are suitable if you want to load the compiler as 
high in memory as passible. For the main text, we will assume as an example that ACCEL3 is 
loaded on a 32K machine. In this case your answer to the initial MEMORY SIZE? question 
will be calculated as follows- 

49152 ("Upper limit of memory on a 32E machine) 
-5632 (Size of ACCEL3 compiler) 

43520 = "SA\ starting address of the compiler. 



1) On Video Genie (PMC-80) you don't get the MEMORY SIZE? prompt. However, on power up 
the machine gives you the opportunity to enter a number after the first READY^. This is 
exactly the same number referred to as "SA" in these examples. 

2) If you are going to use TSAVE to make either a tape backup copy of ACCEL3, or to save 
the compiled program, then allow a further 512 bytes of protected memory, i.e. set SA=43008 
instead. 



TABLE OF U SEFUL MEMORY ADDRESSES 

The first table gives values of addresses you can use in order to locate ACCEL3 as high in 
your machine as possible, (assuming you have no other machine-code programs above it). 



16K 


32K 


48K 




32767 

27136 

26624 

27136-32767 

27136-28671 


49151 

43520 

43008 

43520-49151 

43520-45055 


65535 

59904 

59392 

59904-65535 

59904-61439 


Top-of -lienor y address 

Start of ACCEL3, and JO SIZE • 

YB\ SIZE, (leaving 512 bytes for TSAVE) 

BACKUP range to save ACCEL3 

Rurrtine routines 



This second table gives address ranges you can use when compiling programs to sell on a 
smaller machine. ACCEL3 has a run-time component of only 1536 bytes, and this table shows 
you how to ensure that only the minimum amount of ACCEL3 resides in the end-user's 
smaller memory. 



16K 


32K 


Target Machine size 


31232-36863 
31232-32767 


47616-53247 
47616-49151 


ACCEL3 address range, on your machine 
Run-tine routines, in end-user's nachine 



LOADING THE TAPE SUFFT.TFn 



1) 



2) 
3) 
4) 
5) 
6) 



(or your value of "5A"). 



rOORY SHE? 43520 (enter) 

RADIO SHACK LEVEL H BASIC 

READY 

SYSTEM (enter) 

i? ACCEL3 (enter) 

Tape loads... 

*? / (enter) 

TARGET ADDR? (enter) (or any chosen protected address). 
FEADY 



Notes. 

llI^jTJ^! n X ?r0CE5S , at 5t ! P 4 iS a 5tandard ^-image tape load, and is subject to 
the usual variability on volume, head alignment, etc. A pair of asterisks will blink on the 

Re£v frnm"? a ^ Bri !K S ?S arf ° r if a C iS dis P la y Bd * then thB ' e has been a loading error, 
a In. H ZullM a dlffe 1 i ; ent valume settin 9' (Southern Software tapes are recorded at 

rtn ™ F generall y c °™ion, since this gives a wider tolerance to fluctuations). 

ri.I S o 6 !^ 6 5U P plied , Dn the ta P e ' in ose on e gets damaged. Damage is almost invariably 
MS^rS^Th a tape J 1 "* i tin y fald in the ta P e) or to recorded noise, caused by 
E2~^?5 th *J?il puter in the middle af a ta P e load ' ^ways stop the cassette player 
before hitting RESET on a bad load). 







2) Step 6 lets you relocate the compiler anywhere in protected memory. IF you just hit enter, 
then it relocates to SA, the answer to the MEMORY SIZE question. IF you have other 
machine code programs you want to hold concurrently in memory, then you may wish to 
respond with a value diFFerent From SA. 

3) On Video Genie, For (enter) read NEW UHE key. 

4) Some other products, e.g. the EXATRON stringy Floppy, actually modiFy the PROTECTED 
MEMORY value. While not causing an error this can be very conFusing, since it could cause 
ACCEL3 to relocate to a diFFerent address than you expect. IF in doubt use an explicit 
target address at step 6. 

SAVING A BACK-UP 

You can now save your own, Fixed-location back-up copy oF ACCEL2. This can be on tape, 
disk, or waFer. It will be shorter than the original File, but more important, it will load 
under either Level 2 or DISK BASIC, and it will load directly at its Final location, without 
corrupting location 13944 and up. The loading process can also automatically activate the 
compiler. 

A) Backup on tape. 

To prepare a core image tape, on Level 2 or DISK BASIC, you will need either the Southern 
SoFtware utility TSAVE, or TRS TBTJG. TSAVE is recommended, because it allows you to 
work in decimal, not HEX, and to check the saved tape. In this example the memory ranqe 
you need to save is 43520 to 49151 

Using TSAVE, respond as Follows: 



FILENAME? BACKUP (enter) 

RANGE? 4352M9151 (enter) 

RANGE? (enter) 

START? 43520 (enter) 

R (enter) 

Tape records... 

Reposition, 3rd type C, to check, tape, 

This tape can be reloaded byi 



(or your own file nawe) 

(start address, to activate compiler) 



SYSTEM (enter) 
x? BACKUP (enter) 
Tape loads... 
x? / (enter) 
READY 



(or your own filename) 

(ACCEL3 is now activated, see later) 



Note. On Model HI, under DISK BASIC, the SYSTEM command does not Function correctly. In 
eFfect you cannot load SYSTEM tapes while in DISK BASIC. 




B) Backup on Disk. 

Go into TRSDOS (or NEWDOS, etc.) from Level 2 by hitting RESET. (This will not destroy the 
stored image of the compiler). 

Type DUMP ACCEL3/CIM <START=43520,END=4915l,TRA=43520) i.e. SA to SA + length of 
ACCEL3» (For Model m, these addresses must be converted to hex). 

This file can be reloaded under TRSDOS by typing LOAD ACCEL3/CIM. When you enter 
Disk BASIC after loading ACCEL3/CIM set MEMORY SIZE to 43520, or to your value of SA. 
See also later section an LOADING THE COMPILER FROM DISK. 

C) Backup on Wafer.(EXATRON Stringy Floppy commands assumed). 

The address tD save is 43520, with length 5632, and with autostart 43520. Because 43520 is 
not representable as an INTEGER, you will have to type it in modulo 65536, i.e. as -220 16, 

So type @SAVEn,-22016,5632,-22016 

This can be reloaded (under Level 2 Dr DISK BASIC) by QLOADn 



ACCEL3 SUPFT.TFn QN DISKETTE 

ACCEL3 is supplied on disk in relocatable format. You must use the disk appropriate to your 
system, i.e. Model I (including Video Genie), or Model in. If you have received the wrong 
one, return it immediately for a replacement. The final relocated program is the same on all 
machines, it is only the disk format that differs. Once installed, you can CONVERT the 
saved file from Model I to Model m, but you cannot CONVERT the product disk. If you have 
been supplied with a double-sided disk, then the Model I format is on the front (the labelled 
side), while the Model III format is on the back. 

DPut the ACCEL3 disk in drive 0. 

2)Press the RESET button (i.e. BOOT the system). 

3>The COPYRIGHT notice will appear. Press "ENTER to install ACCEL3. 

4)Answer the address relocation question. To load ACCEL3 at the highest suitable address 
on your system, simply hit ENTER. You need only bother with an explicit address if you 
have other machine-language routines you want to have loaded at the same time as ACCEL3, 
or if you are preparing programs compiled under ACCEL3 to run on a system with a smaller 
memory size than yours. 

m™™^ ^*^ addr5SS at Which the ^P^' sa y 5 ACCEL3 is loaded. Use this as 
MEMORY SIZE under BASIC. 

6)Remove the ACCEL3 disk and place in drive your own system disk. Use a TRSDOS disk 
for Preference. The installation process will work on TRSDOS and some, but not necessarilv 
all other DOS s. 

7)Press ENTER. (Do not REBOOT!) 

^L system » il } n °w aPP ea r *° REBOOT, i.e. the operating system will load. If you have an 
eVe^eT^ *" **** WU1 ^ dispIayed Dn the screen ' but * »& NOT have been 

1^!™!^ WiU ^ f BCUtEd and the relocated core-image file, named ACCEL3/CIM, 



will be DUMPed an your system disk. The size will be slightly smaller than 563: 
published upper limit. 



which is a 



DOSam ^ ?rSE^ , \ fl- incom P atlble form ^ °" many operating systems, e.g. 
THSDM an?iSS?r f ?\ at thlS ***' ° X yOUr a P eratin 9 »y*«n » incompatible with 
THSDDS and DUMP fails to appear, simply type the DUMP command by hand, using the 

^T^trlLr^ 3 ' AltE ™t t i V ?, ly ' d0 the DUMP on t0 * TRSDQ S disk, and then COPY 
or CONVERT the file to your DOSPLUS or HEWDOS80 disk, etc. 




LOADING THE COMPILER FROM DISK 

To use ACCEL3 an future reboots, you can type LOAD ACCEL3/CIM under TRSDDS (or 
NEWDOS, etc*) and then enter DISK BASIC in the normal way, specifying MEMORY SIZE to 
protect ACCEL3. Once in DISK BASIC you will have tD activate the compiler, by branching to 
its first location, as described later* Although the dumped file, ACCEL3/CIM, specified a 
TRAnsfer address, it's no good executing this branch under DOS (by using the file as a 
command). When you enter BASIC the compiler would get deactivated. Unfortunately, loading 
the compiler under DOS has the danger that the invocation of BASIC itself may corrupt high 
memory, destroying what you've just loaded. TRSDOS on Model I corrupts the top 64 bytes, 
while TRSDOS on Model III is even worse. The DO command, if used, endangers the top 500 
bytes, but also there is a chance that if the timer interrupt fires while BASIC is setting up 
its stack, then even lower bytes may be corrupted. And of course other DOS's may have 
their own quirks. 

1) } ¥ , ? r J RSD0S, on Model Xt ^way 5 leave the top 64 bytes unused, LOAD the compiler 
under DOS, enter BASIC, and then activate it by branching to its first location. 

2) If on TRSDOS, on Model in, do not risk loading under DOS. Instead enter BASIC (setting 
the correct protected memory address) and then load the compiler by CMD H r , ,"ACCEL3/CIM H 
which loads and branches to the compiler's first location, thus activating it automatically. 

ACTIVATING THE COMPILER 

You've got to this point in the scenario after first installing ACCEL3 from a Southern 
Software tape or disk, and you may have made your own backup copy on tape, disk, or wafer. 
If you are starting from scratch after a reboot, then, given a backup on tape, Model III disk, 
or wafer, you should get into BASIC first, with memory correctly protected, (either Level 2 
BASIC or DISK BASIC). Now load your backup and the compiler will be automatically 
activated because! 

1) From tape, / (enter) after tape load branches to the START address. 

2) From disk CMD 'T7*ACCEL3/CIM" branches to the TRAnsfer address. 

3) From wafer QLOADn branches to the autostart address. 

Alternatively you may be running directly from the product tape, i.e. you loaded the tape 
Tnn^T^Xh^ 6 y ° U noW want t0 ^P 115 tne sample program. Or, you may have loaded 
r^TT disk Under D0S on Madel X > and y° u nave now entered DISK BASIC. In 

both these cases you must First "activate" the compiler by branching to its first location. 

SYSTEM (enter) 

*? /43520 (or your value of SA) 

READY 







CREATING A SA MPLE PROGRAM 

Despite the triviality of the fallowing example, it does illustrate most of the mechanics of 
compiling a program, and of saving the compiled program* 



10 'StffH 

20 DEFTM I-J 

30 FDR 1=1 TO lOOOIKEXT 

40 A$ = A$ + "i" 

50 PRINT JJ A$J 

60 J = J + 1 

70 F J<5 THEN 30 

B0 STOP 



List the program, check it, run it, and change it, if necessary. Once you have compiled it you 
will no longer be able to EDIT it, So SAVE it on tape, or disk. ™mpnea you 

COMPILING THE SAMPLE PROGRAM 

Once ACCEL3 is activated you can execute its builtin commands which are BASIC keywords, 
compile typet * ^^ NE ™ 0S8 ° * D0SPLUS > P«=d. the slash by a K?o 



/FIX (enter) (i.e. FIX proqrs* in nschine-code) 
ACCEL3 (C) DPYRIGHT SOmERN SOFTWARE 1982 

116 98 HI (These three values are the changing proqrs* size) 
READY 



k 



L 




'/ 



Use of the word FIX is intended to remind you that your BASIC program has now been 
irreversibly converted to machine-code. You cant EDIT it in any way, but you can LIST it. 
Shown in comparison with the original, it will look like this: 



Before Compilation Compiled by ACCEL3 

10 'SAHFLE 10 : 

20 DEFINT I-J 20 DEFINTI-Ji 

30 FOR 1=1 TO 1000JFOT 

40 A$ = A* + "x" 

50 PRINT JJ A*; 

60 J = J + 1 

70 F J<5 THEN 30 

80 STOP BO STOP 



Notes. 



| 1) Lines in the program that have been converted to machine-code do not appear in the 

listing. (The actual machine-code itself follows the dangling I, but is unprintable). 

i ll\?~vi" er Z K efine . f INTEGERs in line 20 > ** ^ a result the machine-code compiled 

4 by AC^EL^. will be much faster than if they had been float variables (SINGLE or DOUELE), 

f 3) ACCE ^3 compiles line 40, the STRING assignment, although ACCEL would not. 

I 

4) DEFINT, and STOP were not compiled, but the run-time environment is smart enough to 
ensure that the BASIC interpreter is passed control for these statements, and that its 
j understanding of any variables they refer to is the same as that of the compiled code. 

| RUNNING THE COMPILED PROGRAM 

i 

RUN (enter) 

x 1 xx 2 xxx 3 xxxx q xxxxx (program rire) 

BREAK IN BO 

READY 

I 

1 

A second RUN will rerun the program* GOTO 10 or GOTO 20 will reenter the program 

( without resetting J to or A* to null. GOTO 30, or a reference to any of the lines that ha^ 

SSS?^^ 1 TE* ^ ^ Xm Y DXED LINE OTMBE * message." RUN it again [, but tit 

S ?hTte? ™ £ rD9ram l TB mm P lBtlDn * Note that this throws you into READY, 

SmNT , K message. Type ?IJJ } A$ to interrogate the current values of the 

workln %f!J r,™ fH CDmP l d i lxne , f ° r in *" intBr Preted line. In the latter case, CONT will 
f i^nt ?^J!? ^f iS ^ arS CD,nrect - Type J=2 > and then GDTD 10 tD re5 ^t 

f nn^lZ * m ° dlfied ValUe ° f Jf Tum trace on ^ ^^9 TRm * ** re ™ the program. 

Only the uncompiled lines are traced. Turn trace off again with TROFF. 

[ nPT B JS U w h f^? mpiled a P ra 9^am» you can no longer use the commands EDIT, AUTO, 

1 SSs^l^J?T Jmb ^ , : 0,r I P H ? E# ThlS iS beCSUSe the "^ne-ade in the compiled 

lines may contain bytes that are treated as control codes by the interpreter. So use of these 
commands may cause an infinite loop, or a machine reboot. To get the machine back to its 

W^w !n at rM° U "^ U5S NEW ° r CL0AD ' 0r in DISK BASIC * L OAD or RUN 
program-n^me". All of these destroy the compiled program. 




SAVING THE COMPILED PROGRAM 
A) On tape* 

DType CSAVE U A" (or any other file name). 
2)Rewind the tape, and check it with CLOAD? 
3)Type CLOAD, and RUN to reload, now, or at a later date, 
Notes. 

DTo CSAVE or CLOAD a compiled program, ACCEL3 must be active. Otherwise the results 
will be unpredictable. 

2)You can CSAVE or CLOAD an uncompiled program, with ACCEL3 active, without anv 
restrictions. J 

3)You must have exactly the same environment in effect when you reload a compiled 
program, as when you saved it. ACCEL3 must be in the same place, you must be running 
under the same operating system (TRSDOS, NEWDOS, Level2, etc), and you must have 
specified the same number of disk I/O buffers. 

B)On disk! 

DType SAVE "PROG" (or any other FILESPEC). 

2)Type LOAD "FROG" to reload. 

3)Type RUN "PROG" to load and run. 

Notes. 

DTou must have ACCEL3 active to SAVE or LOAD a compiled program. 

2)Tou must have exactly the same environment in effect when you reload a program, as when 
you saved it. ACCEL3 must be in the same place, you must be running under the same 
dis^^buSrs"! (THSD0S * NEWD0S * etc '>' *" d y°" must have specified the same number of 

FILE e NOT°FOraD ln9 ** ^^ ^ *** DpBrating s y stem ' which <*ay produce messages, e.g. 

4)The source file of a program, and the SAVEd compiled program are two very different 
things. It's easy to inadvertently SAVE a compiled program usina the same name as the 
source. If you do this, your source is lost for ever. As a discipline, use "FROG/BAS" for the 
source file, and "FROG/ACC" for the compiled file. 



,-V 




MEMORY MAP. 



DROH <W SYSTEM CODE. This includes the 12K ROM supplied with 
sour Machine, the display and keyboard memory-mapped I/O, 
system control blocks, and the Disk Operating System, if used. 
The upper address lies between 17000 (under Level2) and 28000 
(under TRSDOS, Depending on number of I/O buffers). 

2JBASIC PROGRAM. The program is compiled in-place by ACCEL3. 
Depending on the number of comments and blanks, you nay find 
that your program either expands during compilation, or 
contracts. An expansion is the norm 

3)SCALARS. This is a table of non-array variables, including 
the names of the variables, their types, and their values 
(except STRING values). For an uncompiled program the SOLARS 
are Destroyed by R\M or CLEAR, and then rebuilt incrementally, 
as used. But compilation builds this table permanently, and 
compiles references to it. This area effectively becomes a part 
of the program, and it is saved on tape or disk, when the 
program is saved. 

^ARRAYS. This is a table of array variables, and it is built 
incrementally both by the interpreter and the run-time routines 
in ACCEL3. But ACCEL3 remembers the address of each array, 
after the first reference to it. 

5)FREE SPACE. This is what's left between the top of the 
arrays, and the bottom of the stack, ttwn they meet, OUT Of 
rOIORY results. Note that compiled code may fail to diagnose 
OUT OF fEHORY correctly. 

6)STACK. This is used for expression temporary results, for 
calls within the run-time routines, for FOR-tBCT and for 
GOSIBHOJRN. The compiled code generally uses less stack than 
the interpreter, although neither uses a great amount. 

7JSTRING SPACE. This is where string values go. It's the same 
size (the value set by CLEAR N) in either a compiled or an 
interpreted program. However its use is not identical, and 
ACCEL3 will generally reduce the frequency at which garbage 
collection is necessary when strings of equal length are used. 

8)RUN-TU£ ROUTINES. These must be in protected memory, and 
they must be in the same place when you attempt to load and 
rerun a compiled program, since the program contains direct 
references to this code. If you sell or give away compiled 
programs to a third party, you must include these routines. 

?>COrPILE-TIrE ROUTINES. These routines convert the BASIC 
statements into machine-code. They are not necessary at 
run-time, and indeed must not be sold or given to any third 
party. If you compile a program on a 48K machine to run on a 
1AK or 32K machine, then you should arrange that these routines 
lie just above 32768 and 49152 respectively. This will maximise 
the space available to the running program. 



low: 
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MORE ON COMPTT .ER ACTIVATION 

I!^J? S " 80 rB ^ el2 b , * de in ? OH P ravides a table °f transfer addresses through which flaw 
foHo"ng situlti^ns? * '" eIeDJti ° ^, ACCEL3 use * 3 °f these to get control in the 

1) At the beginning of execution of each progran statement. 

2) At the begiming of execution of each direct comand. 

3) After execution of RUN, *H, OEBR, UW>, and EM). 

When you branch to the starting address of ACCEL3 it enables these traps by puttinq its 
own addresses in the transfer slots. Because ACCEL3 then gets control on each command or 
f.!th / % lS w su PP° rt new commands of its own, which it chooses to distinguish 

!'!£ t/ Pr 1 _f y .° ther P rodurts use a ^U^ technique. ACCEL3 attempts to coexist 
br^ch,n n Se t n P [J IT l P reS r erVi ". 9 "" ^V™* tranSfer iddrBS5 ' durin 9 artivation, and 
miction with ACCEL3 may not be so kind, but may simply overwrite the original transfer 
^rn,^L? h thBlr ° wn ' thus "disabUng" any other product playing the same trick. If you 
encounter this problem, solve it by activating ACCEL3 last. ' 

«^3* >* rB tf i V4ti T iS i9n ° red by the ^P^' However, once a switch has been 

^stilVactTe Sn e Arr"A StBr * *♦ " ^^ Were destro V ed in ™»™ry while the switch 
was still active. So ACCsLS supports a command, /RESTORE, which will reset the transfer 

y^!, to th f r "?inal values, i.e. will deactivate itself. Use this before you overwrite 

sSLlS • f T^^ D9ra^, • Qtherwise y°» O" l«avo it active indefinitely. Tou can 
switch back into THSDOS, and then re-enter BASIC without destroying ACCElI However 

nro™ Tou ttrf ',**! Tk ^^ if y ° U USS BASIC * tQ Preserve a CDm P" ed ° r ""compiled 
program. Tou can also load the core-image of ACCEL3 from within BASIC, if you are runnina 
under NEWDOS or Model in THSDOS, provided it loads into protected memory^ 9 

farTflrit lit ^ 3 determines " hether ° r not the r ^i°ent program is ccmpiled by looking 
!l Wh=n Trr^T f 9 °" ly °/ a Sin9lB CDl0 " (0 * So no sourCE P r °9 ram m ^ tart in this 
execute ^n-Kr^J \* S V*? ba S lnnin 9 ° f a BASI ^ statement, the decision to 
H^Sl„n r f^ rather than to leave a statement to the interpreter is based on 
r^Tl* / ° n ' f0U ° Wed by line " end - On» ACCEL3 has made the switch to in-line 
code, this code runs uninterpreted through one or more statements or lines, until the next 
uncompiled statement is encountered. INTEGER operations, GOTO, GOSUB, and RETURN are 

^Sr^^SST b J£?S?- H ° WeVer * n - int ^ e r asslgn.^ExTarrly 
tw! fh^ 9 ' J ^ ' E,T * and PMNT ' ^ CDntain a " fast " tB st for the BREAK key. 

Ifferted Ty s'Sd^nf *" 7^' "" *"" "^ " not CQI "--»- Thi. trap is no" 
u^TS^ I^t ' and If y0U Want tD su PP ress it. then you should POKE byte SA+7 
ACCE^f ^^uchon <X'C9<, decimal 201), where SA is the Starting Address of 



V. 




^ 



L 



CHAINING PROGRAMS FROM DISK 

ACCEL3 allows you to chain programs together, i.e. to proceed through a sequence of 

h» Sfhl P ? Whld ? P reserves triable values aross RUN). The chained programs may 
SJh^T compiled or interpreted, or a mixture. You will need to debug these segments in an 
arbitrary order, compiling each one after it is checked out, and you will not want to change 
the chaining program, when the program it chains to is compiled. 

The best way to achieve this is as follows. Adopt the convention that source programs are 
named e»g. PROG1/BAS, while the compiled version of the same program is PROG1/ACC. 
Since you want your final set-up to run compiled, use RUN "FROGl/ACC" etc. anywhere a 
chaining statement appears in a program. While debugging, simply store a double copy of 
each source program, one as BAS and one as ACC. So initially the whole system runs 
%^^'r 2™' "J™ PH ° G1 iS debu S9«l, save its compiled version over the top of 
FROGl/ACC. Your total system will run as a mixture of compiled and uncompiled routines, 
while you gradually check out and compile the various sections. 

SELLING COMPILED PROGRAMS 

One of the major attractions of a BASIC compiler is that it enables you to write BASIC 
programs for sale which, with care and tuning, can be comparable in performance with 
machine-code programs. Secondly, and no less important, a compiled program is very 

i ™Vh * B ?. - A Can bS CDpled ' ° f courSB ' 5ince ** filB can be CD ? ied *yt B for byte, but 
LTh ° , S m ° dlflBd : «=?* ^ the awnBr * the original source BASIC. And of course you 
dont have to release this when you sell a compiled program. Y 

ctl^L^ iS an t , un P°P u ; ar medium > it has a number of very significant advantages, 
tn nn=t w T* ^ "? therefore expendable or replaceable. They are small and Hght 
HnX t^ tps fin U H V1 Tf V1D i^™ dling * UnlikB diskettB * which need a lot of protection. 
^^U^S^n 1 " 7i ™ ^Tf ' iS Part ° f R0M ' and theretoe distent on 
So^^Sr^^ enOU9h t0 l0ad " y nUmbSr ° f ******* S *» 5 *'«** 

three ^dre^s r^geT ^ "° *°* T ° ^^ * S5lf ~ cantained ^* Y™ ^e to save the 

3) Control storage, (including progran size, nenory size, etc). 

b) The program itself, including its dictionary of scalar (non-array) variables, 

c) The ACCEL3 run-tine routines which interface the running program to interpretive BASIC. 
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To save these ranges you will need Southern Software's TSAVE utility (TBUG is not 
satisfactory). Relocate TSAVE in a separate area of protected memory, or better, prepare an 
absolute-address copy which will load on top of the compile-time routines, after 
compilation is complete. Invoke TSAVE and give the following responses- 



FH-ENAHE? HYPKOG 
RANGE? 16512,16863 
RANGE? 16518t, 16635 1 
RANGE? 43520,45055 
RANK? (enter) 
START? 6681 
R 



(save control storage) 

(save the compiled progrsn) 

(save the rut-tine routines, i.e. SA to SA+1536) 

(dunny start address) 
(record) 



Notes. 

DLocations 16512 to 16363 contain control information such as program start and end 
addresses, dictionary size, MEMORY SIZE, etc. So when the tape is reloaded MEMORY SIZE 
is automatically set to what it was when the tape was saved. Also, ACCEL3 is automatically 
activated. 

2)1654Stto 16635*means save the range defined by the values contained in these locations. 
This includes the program itself, and its dictionary of scalar variables, but not the array 
variables. 7 

3)To run the compiled program you must have the ACCEL3 run-time routines available, and 
in the same place as when the program was compiled. These routines constitute the first 
1536 bytes of ACCEL3. So the values in this third range depend on where you oriqinallv 
decided to load the compiler. y 

4)If you want the final program to run on a smaller machine than yours, then you should 
arrange that the 1536 bytes of run-time routines fall just within that smaller memory. See 
the earlier table. 3 

5XDn Video Genie, use the ESCAPE key for upward arrow. 

Whether on tape or disk, do NOT save the whole of ACCEL3, or you will be regarded as 
infringing the copyright. Also, you must give an acknowledgement in your program 
documentation that it was compiled by Southern Software's ACCEL, ACCEL2, or ACCEL3. 




w™n^c the sltuatlDn is not so simple, The DUMP routine provided under TRSDOS (or 
55vS WlU ° nly SaVe a 5inQle CDnti 9 UQUS corB image» and it cannot save any range below 
HEX '7000'. These two restrictions make it more difficult to sell a compiled program as a 
single file on disk. What you must do instead is to SAVE the compiled program as described 
earlier, as a single file, "FROG/ACC" say, and also to DUMP on the sale diskette the 
rare-image of the run-time component of ACCEL3, as a separate file, LOADER/CIM, say, 
(Again, do not save the whole compiler). This core image is the first 1534 bytes of wherever 
you have located ACCEL3. 

As an example suppose you want to sell a program "FROG/ACC" to run on a 16K machine 
(although you have a 32K machine)* The full sequence is as follows: 

VJSHJ^S^ locatiDn for ACCEL3 is 32768-1536 = 31232. Under Level2 set this as 
MEMORY SIZE, load the original self-relocating version of ACCEL3, and locate it at 31.ro 



2) Return to TRSDOS and DUMP this version of ACCEL3 as a core-image file for your own 
use* J 

W^/Yr?^!^^™!^?. 11 ™ 2511 ° F FILES tD wh * teve ' will be required by 
PROG/ACC, and the MEMORY SIZE to 31232 again. 

ll^?^ hS SOUrC5 f ° r PRQG/BAS » co^ile it, and then SAVE the compiled program as 
^ROG/ACC as described earlier, but onto a new master disk, 

5) Return to TRSDOS and DUMP the run-time component of ACCEL3 (just the first 1536 

^!!i °" this new master di5k ' M a file called LOADER/CIM, say. I.e. DUMP LOADER/CIM 
<START=31232,END=32767). Use Hex addresses on Model HI. u*u*k/li« 

6) This master disk will now contain two files PROG/ACC and LOADER/CIM, not the full 
core-image of ACCEL3. TRS BACKUP is now a convenient way of making copies of this disk 
for sale. 

Your operating instructions must now include the fallowing directions to the end-user. 
(Alternatively, you can automate the procedure with the use of Southern Software's 
Ccmmand-List processor, EXEC). 

1) From TRSDOS load the run-time routines by LOAD LOADER/CIM. 

MEMORY^ ^3?^2 S T ttin9 ^^ ° F FILES t0 * ^ """*" Y ° U USSd Barlier) and 

3) Activate the loader by SYSTEM (enter) and *? /31232 (or DEFUSR under Model III). 

4) Run the compiled program by RUN "PROG/ACC", 
Cautions J 

7n a£5Lp™ 1° PrDVl i e di ^ ferent inductions for Model in users, e.g. to load and activate 
LOADER/CIM from within BASIC using CMD'T'. Also, depending on which operating system 
your end user will have, you may need to leave e.g. 64 bytes free at the top of memory, to 
avoid overwriting. " 
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EXECUTION PERFORMANCE 



Jh^fr ° f "I™ 9 ^ CDmpiler is t0 ^prove execution speed. But the compiler cannot do better 
2?f«ttTll WWCh tHe Pr ° 9ranT rm " ThS Z8 ° CPU M * iS — ^ly che^ reliable 
b^ execu'te^ v a ca^ Hhm^T ° P ™ ns (SUCh aS mulUply M divide) * T ^ se ^e to 
sucS^vf Jrif^ ??? r0Ut ^ eS WhlCh Pr ° Vide the rec * uired functi ° n ( e.g. multiply by 

J^^f^dp^ h ? f f CDUr5B rBUtiVeiy SlOW * The CDm P lei table * th ^d of 
tms section is a. guide to what features can be improved by compilation, and by how much. It 

remains one of the programmer's tasks (unfortunately), to match the requirements of the 

problem to tte capabilities of the underlying computing system. The ex r^ffoTnLded to 

optimise performance could be thought of as a form of machine-code programming It ca^ 

ZctZr^tlZ7ZT e ^ P h erfQrmanCe Wlth rSai aS5embler lan ^4 -dTg^ut it^ 
incomparably easier, because debugging is in BASIC, using PRINT statements, TRACE, etc. 

m^^^^^^^ZT WhlCh iS a miXtUrB ° f BASIC dements »d directly 
a^d^Lrfornf^r h* ™* uc ^™* The 280 can execute branches and subroutine calls! 
Tn SINGLE ZnOVBl^ ^ lthm * tlc < e *^ding multiply and divide) on INTEGERS, but no 
intern^ form nf pa^tp p ? asian Rating-point numbers. Nor can it directly manipulate the 

»o^ quite f^LST^^it "IT* StrlpS ° f bytBS - frDm ° ne ****** * 
dynantollv So 1cm ♦ * ,* dlfflCult y Wlth st ™9 s is that their lengths vary 

m^it^^^ 9 ^^ 5tatemBntS tD ^ UenCES °< <=*■ * -tines in' 

In addition to the actual execution of the program operations, there is the "resolution" of 
the variable names and line-numbers. Here a compiler comes into its Ln The slsiC 

S reve^ *LT "V- * "^^ BMn=h thrQU9h * 5 ^^-ry^tablfo'f 
S ^storaZ^oAheV.r?^ 6 15 r * fer . BncEd du ™9 Martian. In contrast the comoiler 
rt^ ra ™ k Dra Se «rthe variable once during compilation, and then replaces each compiled 
reference by a direct machine address, rather than a dictionary search. SiSaSTeaS 
Ll 5 + H tD / A c U T H e - nUmber in G0TD ar GOSVB translates to a simple briTaddre^ 

!to"!^ ta!^^ rT^ ° f SBqUential 5earch is that the running time of a program 

Overate tTme tai7to find^.rh ^ T^* yOU haVe in y ° Ur ^ r ™> then the lan W the 

^execut e^c GOTn rn^^Vf ' ^ T 0r * UnS5 in y ° Ur pragram > the lon 9^ « "takes 
LI , .7 r G0SUB * TnB s P e ed of the compiled code, on the other hand, is 

ve^male°a ^t™^^^^"^ ™- mMM that " *S 
s'teme^ch ^A^^^^ *"» *« «"* say how long a 

arauments apply to proor^ to^ B fe™ a J? "1*^"*^. It depends on context. Similar 
REMarks And M 3 nL ^I^r d after "mp^ation. Programs may contain 

JU^arks and blanks. BASIC names can be any lenath. After rnmniu-Hnn In ►*, 
uncertainties rii«n noa r - *-k« or:** i _, T; y xeuytn. itrrer compilation all these 

uncerxainnes disappear - the REMarks and blanks are removed (from translated code) anri 
the variable and line references are all two-byte addresses. translated code) and 



So .he table that fallows is in one sense very pessimistic, 
smallest program in which they could be measured, i.e. a 
blanks or remarks in the source, and the names were all 
improvement measured for GOTO, for example, is 216 to 1. 
even greater. But the catch is that this figure may be 
executing operations are so fast, they scarcely contribute 
performance becomes dominated by those operations that 
the out-of-line subroutines, e.g. Multiply, or by I/O, 



The timings were all taken on the 
simple FQR-loop. There were no 
two bytes long. The performance 
In a large program this would be 
irrelevant. Because the directly 
to the execution total at all, and 
are not compiled, e.g, READ, by 
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S^l^D/SPACE Performance Table 



Speed Iflprovenent(Ratio) 



M 



inf 

5.2 
38 
149 



SNG 



DBL STR 



178 


28 


3,5 


3.6 


3,0 


3.0 


35 


1.8 


23 


2.0 


57 


1,8 


48 


1.8 


1.5 


1.5 


1.08 


1.17 


77 


70 


7.1 


1.9 


111 


6.8 


10 


4.5 


47 


4,6 


33 


4,3 


50 


6,8 


1.2 


1.01 


61 


5,0 



20 
3,6 
3,0 
1,6 
1.6 
1.4 
1,3 
1,1 
1,02 
84 

4.8 

3,6 

3,0 

3,5 

5,1 

1.03 

3,7 



216 
74 



inf 

1.9 
2.3 
2.3 



inf 
1,7 
2.0 
2,0 



7,3 
3,5 
3.0 

6,6 
3,6 



9,3 



8.1 



1,2 



inf 



53 

258 
4,8 
4,7 
6,4 

25 

36 

16 
7,1 

25 
5,4 

16 



Operation 



Assignment (LET) 

Array Reference (1-din) 

Array Reference (2-din) 

AW, OR 

Conpare (=) 

Add, Concatenate (+) 

Subtract (-) 

faltiply (x) 

Divide (/) 

Constant Reference 

FOR-tBCT 

POKE 

SET, RESET 

FTFENELSE 

ON expression GOTO 

ON expression GO&JB 

PRINT sinple-^/ariable 

OUT 



Space Deqr3dation(Bytes) 



M 



Flow of Control 



GOTO 
GOSUB/RETURN 



Functions 



VARPTR 
POINT 
HP 
PEEK 



String Functions 



ASC 

LEN 

LEFTS 

RIGHT* 

KID* 

CVI 

mi 

CVS 

n<s$ 
cw 



-4 
13 
12 
4 
3 
1 
4 
6 
6 

6 

-1 

-1 
3 

-2 


-1 
5 



-3 
3 
5 



SNG 



DEL 





13 

12 

7 

10 

6 

6 

6 

6 

6 

23 





13 
12 
7 
10 
6 
6 
6 
6 
4 



J 


j 


9 


9 








3 


3 


-1 


-1 


11 


11 



-7 
-10 



-3 
9 
8 
3 



STR 





13 
12 

3 
2 



-1 



-3 
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MfllllllilllllllL 



Disclaimers- 

vIh^h^^p "° ™ mmitmen . t is V"P lied fa y these figures. They are subject to all sorts of 
^stant!^' reference a constant depends on the actual value of the 

2) Speed ratios for STRING operations depend on the lengths of the strings, whether the 
strmg is a program constant (a literal), whether the receiving string is the sime length ^ 
the source string, etc. In measurement 4-byte strings were used. 

me^nnfin, "^f ' infinity 1 ' J" the tlbta mBanS that thB rati ° CDuld "°* °e measured 
re^rence^to X * "^ Pr ° Sram ' *"" referBncB tD VARPTH1X) is faster than the 

Jh5!i a "^, nU T h be>rS ^ ^ e SpaCB tahle mean that the ^"Piled code occupied less space than 
the °" S i,^' T Jl eSe numbers arB based ° n the assumption that one statement per line is 

keyLT^dT KT r" ^1 *, ^ ° ** the UnB °-rh 5 ad , for 'he GOTO 
Auction * °«^Piled code this becomes a single 3-b y te 

pro™^™ ° mpilBd thB ' e 1S a ° ne - tim * ^erhean of about 30 bytes. So small 

»r° q l^l ?„ W pessimistic, compared with the table. Also scalar variables become 

part of the program when it is compiled, so use of ?MEM immediately after compilation 

will give apparently pessimistic results. p Dn 

t) ACCEL3 is very different from ACCEL and ACCEL2 in its treatment of both lines and 
shou!d SS not S hP Tr,° f ^ ^^^ °* ^ —^ measurements, the large ratios 
between AC^TTi^!^', eXCSP l t0 "° tB that they are " lar S B "' Significant differences 
while IF ™ ^JS d nm T7p ar ™ t /° R " NEXT and 1 - dSffl ^ references are slower, 
f^ioLTvsSff^st^' SINGLE and D0UBLE aSSi9nnlent Md thS Strin = — "= i0 " 



PROGRAMMING EXAMPLES 

l£? n " ampl6 ? 1 mustratB s P e °«= advantages that can be achieved bv compilation. The 
oort n c ™ W ? y °? tD P ? dUCE mUSiCal notBS from a B ASIC program via tta ape output 

^duT^^cJ^;^JlJ iB ^^ a,mt,,r • CampUed ' atQp "°* B ° f tw ° ° rta - above 

I^T»2l iS ,ft ™>-e worthwhile. Every business application involves some 
requTrements F^st it L = t h y lnput \ Tnls validation has to meet two conflicting 
requirements. First, it must diagnose any detectable errors immediately, and request the 

bTso ,slow° r tn^t S :r d ' f^ *"/ ^^ "** "** be ^* m ^' « ™* "°t 
errors his h^ tta^SS ^ ^ 0PeratDr "■*»*""«- A P^ *™« introducing 

mf !L1„h ? rt ° f CaUS1 " 9 thE P erat °r to stumble, and lose confidence. So in 

^nnilatTon rZ J 6 *7 D* ^^ ** I****™* -Peed-ups as the result of 
compilation. Rather, we are looking for better human factors. 

IoftwarT 1 Dn e ^ P r,7fh amS -ST "f^ 0n tlW tapB ° r diEk l" 3 " rBCEived f ™ Southern 
t^ On d°skThe Tn^r, J "* Eta " dard CL ° AD files °" the reverse (unlabeled) side of the 
system disk If nthlll J ° P mePU WlU 9iVS ■" actiDn mdB tQ instaI1 th em on your 

^::^':TJZ7o e g :z e uiduded * then their ™ nin9 insM ° ns wm ^ - 



(A) SINGLE-NOTE MUSIC MAKER 

is then the tane tinn=? i»*hJ , ?, P ° rt * If the least significant bit of X 



DThe tape output signal is on the larger grey jack. 



mLon Ua + r !Z WaV l makSS d na5ty " Bled ™nic" sound. You can improve the sweetness bv 
putting it through a arcuit with a poor response to high frequency, e.g^OOoVs S'L " 

^^^^l^ a mM J^ P l tCh d ° nQt 9ive a unifo ™ *"«• This is because the 
inner loop has a non-linear overhead which itself depends on the frequency. 

^*c^ *» «"" interrupts produce a 

is two bytes long, XT3MdS^^ tD *""■ "**"**> ™. -tine 



10 'SINGLE NOTE HJSIC HAKER, USING TAF€ OUTPUT PORT 

20 DEFINT A-Z 

30 DIMPU00),L(100) 



40 
50 
60 
70 
80 



'PITCH OF NOTES, FDR 3 0CTA\£S, 128 TO 1024 C/S AFfROX. 
'C C£ D D£ E F F£ G G£ A A£ B C 
'^,268,250,236,223,208,l?6,183,172,161,152,m,131 



'134,126,118,111,104, 97, 90, 85, 78, 73, 68, 63, 59 

' 59, 55, 51, 47, 43, 39, 36, 33, 31, 29, 26, 24, 21 
90 READ N 'NUMBER OF NOTES TD PLAY 
100 DATA 23 

110 'TAKE A PAIR OF SPARKLING EYES 
120 'PITCH OF MOTE, FOR THIS TUNE 

£1 £F?* mi ^^ m m ^ ^TIVE EONS fi£5T 

160 FOR 1=1 TO NIREAD P(I)!NEXT 'PITD£S 

170 FDR 1=1 TO NJREAD UIKNEXT 'LENGTHS 

180 FOR CC=1 TO 2 'PLAY 2 FttASES 

190 FOR C=l TO N 'PLAY N NOTES 

200 LL=0JUR(C) 'LENGTH OF NOTE, IN QLKV^RS 

210 ft=i:iF UK0 TfEN ft=0JL*HJi 'REST? 

220 i=ojk=p<ojl=k:«=o 

230 OUT 255,H 'OUTPUT SIGNAL, 0DO=HIGH, EVEN=LQW 
240 M+10JIF I<L THEN 240 'DELAY, TO PRODUCE PITCH 
250 L=L+K!H=R-H 'SWITCH HAVEFORH SIGNAL 

m LuJJS ,^1L™ M "««• ««WE THE MTU* TD *_TER SFEED OF KJSIC) 

Zl ^ 15IF ^ lm m ' mjm ^A^R KHHTN THIS NOTE' 
2B0 OT C '*OT NOTE 

290 *BCT CC 'JOT PHRASE 

300 HMD 




(B) INPUT VALIDATION 

^mpa^y G9 T^ SK„ % ?°Jf • 0rdBr 5peaficatian fo ' the hypothetical ACHE fright 
S onlv ^h ' P + m H S , a ^ St ° mer aCC0Unt number ' vaUdated far length, far 
BA^IC a verv £l ? V * "^^ " U Check * Whe " thls P™9ram runs under interpretive 
SASIu, a very fast typ 15 t can exit from this field and lose the first character of the next 
field by keying the second character before the validation completes successfully 

The second field is a two-character UB State code, checked against a table of the 50 
Wnf Vn LI rf 5 ' ThlS \ S a ^ cammon f °™ * validation. Other examoles are commodity 
nL PAif, in5UranCe ^^^tions, tax codings, etc, In this case, although an early code 
like CAliforma causes no problems, a search for e.g. WToming causes a visible delay, and -» 
or 3 teyatrakes can easily be lost from the next field. In effect the operator must sVo^d 
^ort^nV; *° n 5 CDmP 1 letS bef ° rB ^"9 the ne * field < Compilation solves t*s 
throughout ^ ' althDU9h ° f C0UrSB " makeS Uttle d ^nce to the overall 

10 'DATA VALIDATION EXAKPLE - FTHGHT ROJTBC 

20 CLEAR 1000 

30 DEFSTR A-H,S-Z:DEFINT I-N 

40 DIM SCC5D) 'STATE CODE 

50 GOSUB 330 'INITIALISE 

60 CLSJPRINT ?10 f "AQ£ FREIGHT COMPANY - HQRK ORDER" 

70 PRINT ei38,"ENTER DJSTOtO NUMBER: ":CHW(30)J 

90 INPUT OJSTNO 

110 SS^™ 05 ™ mn e970 '" CUSmVe »«* W 5 DIGnB»JCH«(30)!:GOTD 70 

120 FOR 1=1 TO 5 

130 OWD$<ajSTN0,I f l) 

12 LThId^^ S,5!;: NDN ^ €RIi: mta m ajSTMR ^»;c™(3q>;:goto 70 

IjU RU)&Un=?u)5littA3ClCNM8 'COHPlfil HODULUS-U Q£CK 
160 NEXT 

» ^S^SS SK^T* 8 lura Fra£D rauB "*™»™»«»«> * 

190 PRINT §266,"ENTER DESTU^ATIDH (STATE)! "JCHttOO); 

210 INPUT STATE 

220 FOR 1=1 TO 50 

230 F STATE=SC(I) MN GOTO 260 'FOUND IT 

240 fOT 

250 FTONT 2970, "INVALID STATE COOE";C^$(30};:GOTO 190 

260 PRINT §970,CH<$(30); 'CLEAR ERROR ^SSAGE, F ANY 

270 PRINT 039VENTER GOODS CLASSIFICATION: "! 

2B0 INPUT GOODS 

2?0 PRINT 2522,-™ OF TEST CASE, m ENTER TO RERUN, '•! 

300 INPUT XJGOTO 60 

330 'INITIALISAnDN 

340 FDR 1=1 TO 50 

350 READ SC(I) 'READ IN STATE CODES 

360 \EZT 

370 RETURN 



C 



// 







PERFORMANCE HTNTq 

Nothing the compiler can do will speed up I/O devices - disk, tape, printer, or keyboard* But 
for processing limited by computation the following are good rules: 

1) Always use INTEGER data types whenever possible, since these are the only data 
?k £S^lJF ro Can mani P ulate directly. You can qualify variable names with % to make 
them INTEGERS, but better is to get into the habit of coding e.g. DEFINT I-P at the head of 
each program. 

2) Because FOR-NEXT processing has tD be "defensive", in terms of handling badly-behaved 
loops, it transpires that a programmed loop (e>g. I=I+ltIF K100 THEN GOTO n) is very much 
faster. So it may be worth using such a technique on critical inner loops. 

3) Avoid continually processing DATA with READ statements, Rather, READ the data values 
once into an array and process from that. This avoids the very considerable overhead of 
converting the DATA constants from character to numeric on every use. 

4) There is a well-known execution "hiccup" caused by string space "garbage collection", 
(recovery of free space). ACCEL3 does not affect the actual garbage collection process, but 
it does attempt to minimise its frequency of occurrence, by avoiding string space allocation 
if possible. In particular, if string siies match in assignment, then a spectacular 
improvement may result. H 

? r 5Sf:L tr0,<e pallin 9 4 ThB ke y overrun example earlier showed how it was possible for 
ACCEL3 to substantially improve the keying characteristics of a program, by reducing the 
processing time between INPUT statements. However there is one situation where the 
compiled program may appear to behave worse. Suppose you have a real-time simulation, 
such as a game like Space Invaders, where your program continually updates the screen and 
periodically polls the keyboard, using the INKEY* function. If INKEY$ is null, you loop 

n°« sf d <TI f ?I m ^ neXt Update * If this update is both lDn 9 ** fuU y compiled, then it is 
possiDie that the player may depress and release a key in between the INXEYS polls. In 
this case the keystroke is lost. Interpretive BASIC reduces the chance of this by polling the 
keyboard at the beginning of every statement (whether or not it asks for input). The cost of 
this poll is high - in a graphics test case, putting the poll into compiled code actually 
slowed down the program by a factor of 3. So it is omitted from compiled code, but included 
in uncompiled statements. (In any case, it's not a perfect solution. Interpreted BASIC may 
also lose keystrokes). If you have a compiled program that you believe suffers from this 
problem, then precede some of the compiled statements in the update loop with a colon C), tD 
force the poll tD take place more often. 
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NOEXPR OPTION 
fing^n e ^ POrtS * mmpile - tifnB °P tion which minimises the level of optimisation. Code the 
REM NOEXPR 

bJk£*t£" SeCti ° n Wh6rB ° ptin,isation is tQ be minimised. Tou can turn optimisation 

REMEXFR 
There are a number of reasons for using REM NOEXPR in front of part of a program: 
exYcu^^^^ eXtBndBd n0n " Tandy lan ^> then this may be a way of having it 

2>The section may make use of ON ERROR GOTO. This may fail in an optimised section 

mayTot £ ^J^^Se* TT* ^^ "" lf " ^ *» *™ ^ ^ 
may nar De up-to-date, so RESUME will not work. 

Til ^^ S ^ e e f ansian> Since mde mansion is not great with ACCEL3, this use is 
a tot T™!^ h WaS , Wlth ACCEL2, H ° WeVer ' arra ^ "*""«• in particular give quire 
thlSL wSrSS. ' ln a ""-P-^^—rtttol section you may prefer to "have 

^Ld^aThTolotr^p^^nlv^ 119 ^ be dUe tD tat «fl«- overn °«- fcr example, 
b^e o? (TOON) 9 oTI?^ ° EX -! H miy SithSr m "" " easier t0 **= fa y ™*«B "ith 

XSdS^J^t^ST" lt> ln which "" " " be idEntifiEd b * ^ 

K^Sn^Vra^*^ ^f at ni nts eiCEpt G0T0 ' G0SUB * as™** Fa *' 

uncomoiied)f M 5 nTiW S,^ ££S3* the statements *«*>" THEN and ELSE are 
to?e mm„- i w ,t * ^ and HHST0IiE are alwa y s compiled. All of the above have 

have a? uncolulh e e n«n D9 T ra ™H °. *"* itS ^^ H ° wever this d ° es mea " «>* if you 
FOR exoressTnn Ai=n * J: langUa9E ertensi °"' X°" cant ever use it in an ON, IF, or 
-limi„J£ f^! V, to| . such expressions fail through INTEGER overflow, you wont 
eliminate the problem with REM NOEXPR. ' ' ou wanr 

GOSUH S I ^hl^ thlt some , non - Tand y l»Bwg« extensions will always fail. For instance 
understood bv AC^/ ""j**, staining a dynamically varying line number, would not bl 
tn^ fac\ that ACr^' *?? C ° Uld n0t " 0rh * The « te ^°ns that function mrrectly rely on 

K^Sr^^di^SSf by ? h s *V he intErprstEr - s ™ 

*tAf» m an+* w ™ ^ variable dictionary exactly as the interpreter expects, such 

malntaTn either Z ^Lt "^ £ ^ ^ they depend °" But ACCE ^ d0ES "* 
maintain either the LINE structure of the program, nor the run-time stack, in a compatible 

tlLf r^BiS^hlT- ^ ni V d fl i nCti ° n refe ' enCB " ith *n *" expression it will pass just 

ttet rlter™ i« ™r?r^? ter§ E ° WeVer 4t a5SUmes that the data ^P* resulting from 
that r J^ ren ^is STNGLE. This may be wrong, and in this case make sure the reference is 
protected with REM NOEXPR. reference is 
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COMMON PTTFAT.T.q 

1) Many programs have loops that are simply there to delay the process, e.g. to make a 
"ball" moving on the screen go more slowly. Either lengthen these loops when the program is 
compiled, or use a SINGLE variable FOR-LOOP containing a very slow operation, like 
DOUBLE divide, which will swamp the compile speed-up. 

2) 100 GOTO 100 is a common way of terminating a program to avoid the READY message 

ST,??,*" 19 thB screen * Tnis lo °P cannot be interrupted by the BREAK key, and will need 
RESET. Instead use e.g. 100 JGOTO 100 

3) If you choose different MEMORY SIZE settings from the example given in the text, or if 
you position the compiler elsewhere in memory, then be sure the address arithmetic is 
correct. This is very error-prone. Work it out on paper first, and type it in from the written 
copy. 

4) When you have compiled a program, do not use the editing commands, since they will 
produce completely unpredictable results. Always reset the machine state with NEW, LOAD, 
or CLOAD. 

5) It is common practice to use DATA statements as a source of variable data. I.e. after 
running the program once you EDIT new values into the DATA statements for the next run. 
This isn't possible once the program is compiled. Instead you have to modify the source and 
recompile. 

' COMFILE-TIME MESSAGES 

These are messages you may get when compiling a program with ACCEL3. 

OH OUT OF ffim, Compiler could not complete. 

FC ILLEGAL FUNCTION. Disallowed statement, e. 3 . DELETE. 

UL IMEFDB) LINE. Bad line nunber referenced in GOTO, GOSUB, RUN, etc. 

SN SYNTAX ERROR. Compiler cant parse the line. 

TH TYFE KEMATCH. STRDG/nuneric data niswatch. 

HO KISSING OPERAN). Chec* the syntax. 

ST STTOT FORhOA TOO COrftEX. ACCE13 restriction. Break, the statement down. 

The result of any error found at compile-time will be to leave the program in an 
indeterminate state. Dont even attempt to LIST it. Note down the error line number, and 
reload the original. 

During compilation 3 numbers are displayed. These are put out chiefly as an aid to see how 
compilation is progressing. The first is the size (in bytes) of the original BASIC program. 
The next 2 are the sizes of the program after the two compiler passes over the program. 

PASS 1 builds the variable dictionary, and modifies some of the source statements, e.g. 
DATA statements are moved to the back. It removes REMarks and redundant blanks, so the 
program size will usually go down. 

PASS 2 actually compiles the code, and is the one that expands the text. 




RESTRICTIONS 

BA^C may' fliUn r ex B °l«n„ CEL "" *"*" hB 5h ° Wn that 50me pr °^ 5 «°*™l «*«• 
tr .the n^I^l. eleajtl °". or even in compilation. These failures were almost always due 

^1=, h 9 „ p r " 91n9 ° nS ° r m ° re ° f the r " tr irtions below, rather than as a result of a 
compiler bug. So if you encounter a problem, believe that it is as a result of a restriction 

£ b £Tu M hS Pr ° blem by traCin9 the Pr °9 ram ' inserti "9 diagnostic TONT sta em^nfs or' 
by breaking the program down into segments. siatemenis, or 

1) No redefinition of meaning of names. 

2!IZrS.«To? «e^Z U H St mean . e "T whether the pr09ram is read 9 loball y « *•» 

compiler sees it, or executed dynamically, as the interpreter sees it. The amhimri+v »»n„ 
co" sisteT An^anir^ ^^ "**» ^ " y ****• Ha ^ "^ SVSK, Sways 

^^iV^^^r^r^s^^ 1 ^ 1 ' Th f intErpreter wiu * eat 

INTEGER, is it «.« TTBTTvrr ^"Q as INTEGER. The compiler will treat both as 

im ifcUfcK, i.e. it sees DEFINT as applying to the whole program. 

l^iT^JZ £ d ° I'll S 1 rt ° f thi " 3 deliberate ly- »ut it can come about, e.g. if 
default swm H - ° P ° f the pr09, ' a^l • CLEAR resets variables types to 

^ S^tTE ^common ^ L^^ *° *■"" ^ ™* ta ™ 

15 DEFINT I-N 
20 CLEAR 1000 



2) Current line-number is not maintained. 

^cLrrent linf^ St f h SmB r nt5 *£* have been nmpiled to machine-code do not update 

^^KK;^^ BASIC dia9n ° stic me55a9es may be misle ^' raoi 

3) Error behaviour is not necessarily consistent. 

S^M?r r -SI Se ^ r , 3UmentS t0 5trins funrti °"S <».g. MUD* offset and length) are rounded 
ST* !li 7aiUeS 0ut - 0f -™se in ON statements are treated as zero, ™t errors 
Out-of-memory may not be diagnosed at run-time, and may cause a wil" br^Si oV a £££' 
Your program mav contain armr* w WrK a a civ m v\ y ,_mj!3K * Wlia orancn, or a reboot, 

reject, for inrtS^b* J£E£ Tn ^ p A =£ ^ " Ct dla 9 n ° se - but whi ^ «* compiler will 
diagnosis X^^f^^^ r ^' r ^ is neve ' eiE ^ Bd - Some error 
FDT? fPo+h =,,«■ "'l 1 '™ 56 ' 6 ^' KETURN WITHOUT GOSUB is diagnosed as NEXT WITHOUT 

^fi=B°THE^ GOTO ,00 IrrrT^ 5t ?T?' IF (A=B) 10 ° is ^ d by the Inter™ » 

IOO.V^OtoToO^o ; ^eSf ^Nt'a ^ *"* ^^ " WiU —* * ^ THEN 

2SS!iLf^ FLC1W iS n0 t necessaril y diagnosed. It is rarely caused by addition or 

w"th ^ w'ronn ! * ^ ""2* thr ° U9h multi P 1 ^«°n. "nich K diagnosed, but possibly 
wirn tne wrong line-number. E.q. A = FEEKCTt + ?sa * xrcr-trrrj.. , • .. • ,, f"»=""y 
calculate a STRING address and urilf m,J*^ r\t .t FEEKII+1) is typically used tD 
i.e. FEHCd+l) i. Treated LT?£ r ^ lf the ad ° reSS is ta the ^ er haif of <«n»ry t 
be SI™ e.g! 2 H!o /Slln.' * ^ Pr ° blem by f ° r ™ 9 ° ne ° f the ar ™ ts "° 

secondly, even if th» «™ w 9 *™f u ma y not be ^S^ by the compiled code at all. But 
secondly, even if the error is trapped, the current line number may be out-of-date, i.e. it is 



seUf a^ou^T S ° RESUME "^ ^ B a l00P ' ArtUaU y this P«*l«» i- not » 
severe as "sounds, because in practice ON ERROR GOTO is almost alwavs u*ed in 

E^ToFnLE etc SinceTo"* 5 V° ^"fj^ N ° T FOTHD ' ° ISK FULL ' ™™ ^ BEYOND 
^wu ut- MLt, etc. Since I/O is nat compiled, the error trap will work, 

4) A first program line of a single colon is disallowed. 

5) Compiled programs may not be EDITED. 

nSf^J™* ha i^ A t^ mpi i ed Pr09ram yDU may not use the «><™ands EDIT, AUTO, 
DELETE, MERGE, and NAME, and obviously these must not appear in a program you try to 
compile. (This gives an ILLEGAL FUNCTION diagnostic). In addition GOSUB should noT be 
used as keyboard (i.e. direct) command. 

6) Operational differences. 

* v J££L P , tlmised# <Td forc:e a Une K to retain its BASIC line number, simply put RUN 
line, m winch case CONTinue may work. Or BREAK may be detected by the ACCEL3 Ubrarv, 
loop. Then you have to reboot. 

7) Saving and Loading compiled programs. 

Compiled programs contain address references to both variables and to code. These will onlv 

rT-time V^^t "h."^ ^ *£" " "«* * "^ thE *™ ^^ ™* 
environment as w^pnth/ San " ^^^ aS WeU1, ^ effect ^'V* u ^e the same 

mnrilTn^ * the program was saved. SAVE and CSAVE can only be used in direct 

mode and may not appear in a compiled program. SAVE and CSAVE of a compiled proqr Jn Ire 
only ^pported for a literal file name, e.g. SAVE "PROG". SAVE expr will no rEg o 
an incompatability between NETTOOS80 and TRSDOS, a compiled program has to be specially 

SAVE m l CS vp re SAV ^° r CSAVE ' 9iVln9 a si 9 ni «-* delay' on a large program! A^o 
ffcT ff CaU5e *" varlaWes tD be cleared, and after LOAD and CLOAD you cannot 

LIST the program or execute GOTO to a line, until some other operation has been performed. 

8) Complexity of STRING expressions. 

of ^s^Tannn^H^ 6 ^ *? inter " rstBr ° n h ° w ="<Pl« STRING expressions can 
sepa^tJem^tf * ™^™' *"« if « <*-, »-* the statement down into 

9) Keyboard Poll. 

^TrStri^ tr S "f PQll , t , he keyb0ard * This may cause cause diff *^ operator 
dte^ ?™ fn^^n K GUy ln aCCeptinS a te y*™«, °' Mure to pause a scrolled 
display, You can force the poll by inserting a colon at the front of a line. 

U C f r ^ii 5 H d w^ bUte r ^ ?" ™ ° aS iS " ba5iSt without wa rranty. No liability or responsibility 
is accepted for loss of business caused, or alleged to be caused by its use. 5 P on51Dmt y 
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